<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>运行时配置</title>

 </head>
 <body><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="session.installation.html">安装</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="session.resources.html">资源类型</a></div>
 <div class="up"><a href="session.setup.html">安装／配置</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="session.configuration" class="section">
 <h2 class="title">运行时配置</h2>
 <p class="simpara">
这些函数的行为受 <var class="filename">php.ini</var> 中的设置影响。
</p>
 <p class="para">
 <table class="doctable table">
  <caption><strong>会话配置选项</strong></caption>
  
   <thead>
    <tr>
     <th>名字</th>
     <th>默认</th>
     <th>可修改范围</th>
     <th>更新日志</th>
    </tr>

   </thead>

   <tbody class="tbody">
    <tr>
     <td>session.save_path</td>
     <td>&quot;&quot;</td>
     <td>PHP_INI_ALL</td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr>
     <td>session.name</td>
     <td>&quot;PHPSESSID&quot;</td>
     <td>PHP_INI_ALL</td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr>
     <td>session.save_handler</td>
     <td>&quot;files&quot;</td>
     <td>PHP_INI_ALL</td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr>
     <td>session.auto_start</td>
     <td>&quot;0&quot;</td>
     <td>PHP_INI_ALL</td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr>
     <td>session.gc_probability</td>
     <td>&quot;1&quot;</td>
     <td>PHP_INI_ALL</td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr>
     <td>session.gc_divisor</td>
     <td>&quot;100&quot;</td>
     <td>PHP_INI_ALL</td>
     <td>自 PHP 4.3.2 起可用。</td>
    </tr>

    <tr>
     <td>session.gc_maxlifetime</td>
     <td>&quot;1440&quot;</td>
     <td>PHP_INI_ALL</td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr>
     <td>session.serialize_handler</td>
     <td>&quot;php&quot;</td>
     <td>PHP_INI_ALL</td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr>
     <td>session.cookie_lifetime</td>
     <td>&quot;0&quot;</td>
     <td>PHP_INI_ALL</td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr>
     <td>session.cookie_path</td>
     <td>&quot;/&quot;</td>
     <td>PHP_INI_ALL</td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr>
     <td>session.cookie_domain</td>
     <td>&quot;&quot;</td>
     <td>PHP_INI_ALL</td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr>
     <td>session.cookie_secure</td>
     <td>&quot;&quot;</td>
     <td>PHP_INI_ALL</td>
     <td>自 PHP 4.0.4 起有效。</td>
    </tr>

    <tr>
     <td>session.cookie_httponly</td>
     <td>&quot;&quot;</td>
     <td>PHP_INI_ALL</td>
     <td>自 PHP 5.2.0. 有效</td>
    </tr>
    
    <tr>
     <td>session.use_cookies</td>
     <td>&quot;1&quot;</td>
     <td>PHP_INI_ALL</td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr>
     <td>session.use_only_cookies</td>
     <td>&quot;1&quot;</td>
     <td>PHP_INI_ALL</td>
     <td>自 PHP 4.3.0 起可用。</td>
    </tr>

    <tr>
     <td>session.referer_check</td>
     <td>&quot;&quot;</td>
     <td>PHP_INI_ALL</td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr>
     <td>session.entropy_file</td>
     <td>&quot;&quot;</td>
     <td>PHP_INI_ALL</td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr>
     <td>session.entropy_length</td>
     <td>&quot;0&quot;</td>
     <td>PHP_INI_ALL</td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr>
     <td>session.cache_limiter</td>
     <td>&quot;nocache&quot;</td>
     <td>PHP_INI_ALL</td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr>
     <td>session.cache_expire</td>
     <td>&quot;180&quot;</td>
     <td>PHP_INI_ALL</td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr>
     <td>session.use_trans_sid</td>
     <td>&quot;0&quot;</td>
     <td>PHP_INI_ALL</td>
     <td>在 PHP &lt;= 4.2.3 是 PHP_INI_ALL，在 PHP &lt; 5 是 PHP_INI_PERDIR。自 PHP 4.0.3 起可用。</td>
    </tr>

    <tr>
     <td>session.bug_compat_42</td>
     <td>&quot;1&quot;</td>
     <td>PHP_INI_ALL</td>
     <td>自 PHP 4.3.0 起可用。</td>
    </tr>

    <tr>
     <td>session.bug_compat_warn</td>
     <td>&quot;1&quot;</td>
     <td>PHP_INI_ALL</td>
     <td>自 PHP 4.3.0 起可用。</td>
    </tr>

    <tr>
     <td>session.hash_function</td>
     <td>&quot;0&quot;</td>
     <td>PHP_INI_ALL</td>
     <td>自 PHP 5.0.0 起可用。</td>
    </tr>

    <tr>
     <td>session.hash_bits_per_character</td>
     <td>&quot;4&quot;</td>
     <td>PHP_INI_ALL</td>
     <td>自 PHP 5.0.0 起可用。</td>
    </tr>

    <tr>
     <td>url_rewriter.tags</td>
     <td>&quot;a=href,area=href,frame=src,form=,fieldset=&quot;</td>
     <td>PHP_INI_ALL</td>
     <td>自 PHP 4.0.4 起可用。</td>
    </tr>

    
    <tr>
      <td><a href="session.configuration.html#ini.session.upload-progress.enabled" class="link">session.upload_progress.enabled</a></td>
      <td>&quot;1&quot;</td>
      <td>PHP_INI_PERDIR</td>
      <td>Available since PHP 5.4.0.</td>
     </tr>

     <tr>
      <td><a href="session.configuration.html#ini.session.upload-progress.cleanup" class="link">session.upload_progress.cleanup</a></td>
      <td>&quot;1&quot;</td>
      <td>PHP_INI_PERDIR</td>
      <td>Available since PHP 5.4.0.</td>
     </tr>

     <tr>
      <td><a href="session.configuration.html#ini.session.upload-progress.prefix" class="link">session.upload_progress.prefix</a></td>
      <td>&quot;upload_progress_&quot;</td>
      <td>PHP_INI_PERDIR</td>
      <td>Available since PHP 5.4.0.</td>
     </tr>

     <tr>
      <td><a href="session.configuration.html#ini.session.upload-progress.name" class="link">session.upload_progress.name</a></td>
      <td>&quot;PHP_SESSION_UPLOAD_PROGRESS&quot;</td>
      <td>PHP_INI_PERDIR</td>
      <td>Available since PHP 5.4.0.</td>
     </tr>

     <tr>
      <td><a href="session.configuration.html#ini.session.upload-progress.freq" class="link">session.upload_progress.freq</a></td>
      <td>&quot;1%&quot;</td>
      <td>PHP_INI_PERDIR</td>
      <td>Available since PHP 5.4.0.</td>
     </tr>

     <tr>
      <td><a href="session.configuration.html#ini.session.upload-progress.min-freq" class="link">session.upload_progress.min_freq</a></td>
      <td>&quot;1&quot;</td>
      <td>PHP_INI_PERDIR</td>
      <td>Available since PHP 5.4.0.</td>
     </tr>



   </tbody>
  
 </table>

 有关 PHP_INI_* 样式的更多详情与定义，见 <a href="configuration.changes.modes.html" class="xref">配置可被设定范围</a>。
 </p>
 <p class="para">
  会话管理系统支持许多配置选项，可以在自己的 <var class="filename">php.ini</var> 文件中设定。这里只是个简短的概览。
 <dl>


  
   <dt id="ini.session.save-handler">
    <em><code class="parameter">session.save_handler</code></em>
    <span class="type"><a href="language.types.string.html" class="type string">string</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.save_handler</em> 定义了来存储和获取与会话关联的数据的处理器的名字。默认为
     <em>files</em>。参见
     <span class="function"><a href="function.session-set-save-handler.html" class="function">session_set_save_handler()</a></span>。
    </span>
   </dd>

  

  
   <dt id="ini.session.save-path">
    <em><code class="parameter">session.save_path</code></em>
    <span class="type"><a href="language.types.string.html" class="type string">string</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.save_path</em> 定义了传递给存储处理器的参数。如果选择了默认的
     files 文件处理器，则此值是创建文件的路径。默认为
     <em>/tmp</em>。参见
     <span class="function"><a href="function.session-save-path.html" class="function">session_save_path()</a></span>。
    </span>
    <p class="para">
     此指令还有一个可选的 N 参数来决定会话文件分布的目录深度。例如，设定为
     <em>&#039;5;/tmp&#039;</em> 将使创建的会话文件和路径类似于
     <em>/tmp/4/b/1/e/3/sess_4b1e384ad74619bd212e236e52a5a174If</em>。要使用
     N 参数，必须在使用前先创建好这些目录。在 <var class="filename">ext/session</var>
     目录下有个小的 shell 脚本名叫 <var class="filename">mod_files.sh</var>
     可以用来做这件事。此外注意如果使用了 N 参数并且 N 大于
     0，那么将不会执行自动垃圾回收，更多信息见 <var class="filename">php.ini</var>。另外如果用了 N
     参数，要确保将 <em>session.save_path</em> 的值用双引号 &quot;quotes&quot;
     括起来，因为分隔符分号（ <em>;</em>）在 <var class="filename">php.ini</var> 中也是注释符号。
    </p>
    <div class="warning"><strong class="warning">Warning</strong>
     <p class="para">
      如果将此设定为一个全局可读的目录，例如
      <var class="filename">/tmp</var>（默认值），服务器上的其他用户有可能通过该目录的文件列表破解会话。
     </p>
    </div>
    <blockquote class="note"><p><strong class="note">Note</strong>: 
     <span class="simpara">
      在 PHP 4.3.6 之前，Windows 用户必须修改此选项以使用 PHP 的会话函数。必须指定一个合法路径，例如：<var class="filename">c:/temp</var>。
     </span>
    </p></blockquote>
   </dd>

  

  
   <dt id="ini.session.name">
    <em><code class="parameter">session.name</code></em>
    <span class="type"><a href="language.types.string.html" class="type string">string</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.name</em> 指定会话名以用做 cookie 的名字。只能由字母数字组成，默认为
     <em>PHPSESSID</em>。参见 <span class="function"><a href="function.session-name.html" class="function">session_name()</a></span>。
    </span>
   </dd>

  
  
  
   <dt id="ini.session.auto-start">
    <em><code class="parameter">session.auto_start</code></em>
    <span class="type"><a href="language.types.boolean.html" class="type boolean">boolean</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.auto_start</em> 指定会话模块是否在请求开始时自动启动一个会话。默认为
     <em>0</em>（不启动）。
    </span>
   </dd>

  

  
   <dt id="ini.session.serialize-handler">
    <em><code class="parameter">session.serialize_handler</code></em>
    <span class="type"><a href="language.types.string.html" class="type string">string</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.serialize_handler</em> 定义用来序列化／解序列化的处理器名字。当前支持
     PHP 内部格式（名为 <em>php</em>）和
     WDDX（名为 <em>wddx</em>）。如果 PHP 编译时加入了 <a href="ref.wddx.html" class="link">WDDX
     支持</a>，则只能用 WDDX。默认为 <em>php</em>。
    </span>
   </dd>

  

  
   <dt id="ini.session.gc-probability">
    <em><code class="parameter">session.gc_probability</code></em>
    <span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.gc_probability</em> 与
     <em>session.gc_divisor</em> 合起来用来管理 gc（garbage collection
     垃圾回收）进程启动的概率。默认为 <em>1</em>。详见 <a href="session.configuration.html#ini.session.gc-divisor" class="link">session.gc_divisor</a>。
    </span>
   </dd>

  

  
   <dt id="ini.session.gc-divisor">
    <em><code class="parameter">session.gc_divisor</code></em>
    <span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.gc_divisor</em> 与
     <em>session.gc_probability</em> 合起来定义了在每个会话初始化时启动
     gc（garbage collection 垃圾回收）进程的概率。此概率用
     gc_probability/gc_divisor 计算得来。例如 1/100
     意味着在每个请求中有 1% 的概率启动 gc 进程。<em>session.gc_divisor</em>
     默认为 <em>100</em>。
    </span>
   </dd>

  
  
  
   <dt id="ini.session.gc-maxlifetime">
    <em><code class="parameter">session.gc_maxlifetime</code></em>
    <span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.gc_maxlifetime</em> 指定过了多少秒之后数据就会被视为“垃圾”并被清除。
    </span>
    <blockquote class="note"><p><strong class="note">Note</strong>: 
     <p class="para">
      如果不同的脚本具有不同的
      <em>session.gc_maxlifetime</em>
      数值但是共享了同一个地方存储会话数据，则具有最小数值的脚本会清理数据。此情况下，与
      <a href="session.configuration.html#ini.session.save-path" class="link">session.save_path</a> 一起使用本指令。
     </p>
    </p></blockquote>
    <blockquote class="note"><p><strong class="note">Note</strong>: 
     <span class="simpara">
      如果使用默认的基于文件的会话处理器，则文件系统必须保持跟踪访问时间（atime）。Windows
      FAT 文件系统不行，因此如果必须使用 FAT 文件系统或者其他不能跟踪 atime
      的文件系统，那就不得不想别的办法来处理会话数据的垃圾回收。自 PHP 4.2.3
      起用 mtime（修改时间）来代替了 atime。因此对于不能跟踪 atime 的文件系统也没问题了。
     </span>
    </p></blockquote>
   </dd>

  

  
   <dt id="ini.session.referer-check">
    <em><code class="parameter">session.referer_check</code></em>
    <span class="type"><a href="language.types.string.html" class="type string">string</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.referer_check</em> 包含有用来检查每个 HTTP
     Referer 的子串。如果客户端发送了 Referer
     信息但是在其中并未找到该子串，则嵌入的会话 ID 会被标记为无效。默认为空字符串。
    </span>
   </dd>

  

  
   <dt id="ini.session.entropy-file">
    <em><code class="parameter">session.entropy_file</code></em>
    <span class="type"><a href="language.types.string.html" class="type string">string</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.entropy_file</em> 给出了一个到外部资源（文件）的路径，该资源将在会话
     ID 创建进程中被用作附加的熵值资源。例如在许多 Unix 系统下都可以用
     <em>/dev/random</em> 或 <em>/dev/urandom</em>。
    </span>
   </dd>

  

  
   <dt id="ini.session.entropy-length">
    <em><code class="parameter">session.entropy_length</code></em>
    <span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.entropy_length</em> 指定了从上面的文件中读取的字节数。默认为
     <em>0</em>（禁用）。
    </span>
   </dd>

  

  
   <dt id="ini.session.use-cookies">
    <em><code class="parameter">session.use_cookies</code></em>
    <span class="type"><a href="language.types.boolean.html" class="type boolean">boolean</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.use_cookies</em> 指定是否在客户端用
     cookie 来存放会话 ID。默认为 <em>1</em>（启用）。
    </span>
   </dd>

  

  
   <dt id="ini.session.use-only-cookies">
    <em><code class="parameter">session.use_only_cookies</code></em>
    <span class="type"><a href="language.types.boolean.html" class="type boolean">boolean</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.use_only_cookies</em> 指定是否在客户端<em class="emphasis">仅仅</em>使用 cookie 来存放会话 ID。。启用此设定可以防止有关通过
     URL 传递会话 ID 的攻击。此设定是 PHP 4.3.0 添加的。
    </span>
   </dd>

  


  
   <dt id="ini.session.cookie-lifetime">
    <em><code class="parameter">session.cookie_lifetime</code></em>
    <span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.cookie_lifetime</em> 以秒数指定了发送到浏览器的
     cookie 的生命周期。值为 0
     表示“直到关闭浏览器”。默认为
     <em>0</em>。参见
     <span class="function"><a href="function.session-get-cookie-params.html" class="function">session_get_cookie_params()</a></span> 和
     <span class="function"><a href="function.session-set-cookie-params.html" class="function">session_set_cookie_params()</a></span>。
    </span>
   </dd>

  

  
   <dt id="ini.session.cookie-path">
    <em><code class="parameter">session.cookie_path</code></em>
    <span class="type"><a href="language.types.string.html" class="type string">string</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.cookie_path</em> 指定了要设定会话 cookie 的路径。默认为
     <em>/</em>。参见
     <span class="function"><a href="function.session-get-cookie-params.html" class="function">session_get_cookie_params()</a></span> 和
     <span class="function"><a href="function.session-set-cookie-params.html" class="function">session_set_cookie_params()</a></span>。
    </span>
   </dd>

  

  
   <dt id="ini.session.cookie-domain">
    <em><code class="parameter">session.cookie_domain</code></em>
    <span class="type"><a href="language.types.string.html" class="type string">string</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.cookie_domain</em> 指定了要设定会话 cookie
     的域名。默认为无，表示根据 cookie 规范产生 cookie 的主机名。参见
     <span class="function"><a href="function.session-get-cookie-params.html" class="function">session_get_cookie_params()</a></span> 和
     <span class="function"><a href="function.session-set-cookie-params.html" class="function">session_set_cookie_params()</a></span>。
    </span>
   </dd>

  

  
   <dt id="ini.session.cookie-secure">
    <em><code class="parameter">session.cookie_secure</code></em>
    <span class="type"><a href="language.types.boolean.html" class="type boolean">boolean</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.cookie_secure</em> 指定是否仅通过安全连接发送
     cookie。默认为 <em>off</em>。此设定是 PHP 4.0.4 添加的。参见
     <span class="function"><a href="function.session-get-cookie-params.html" class="function">session_get_cookie_params()</a></span> 和
     <span class="function"><a href="function.session-set-cookie-params.html" class="function">session_set_cookie_params()</a></span>。
    </span>
   </dd>

  

  
   <dt id="ini.session.cookie-httponly">
    <em><code class="parameter">session.cookie_httponly</code></em>
    <span class="type"><a href="language.types.boolean.html" class="type boolean">boolean</a></span>
   </dt>

   <dd>

    <span class="simpara">
     Marks the cookie as accessible only through the HTTP protocol. This means
     that the cookie won&#039;t be accessible by scripting languages, such as
     JavaScript. This setting can effectively help to reduce identity theft
     through XSS attacks (although it is not supported by all browsers).
    </span>
   </dd>

  

  
   <dt id="ini.session.cache-limiter">
    <em><code class="parameter">session.cache_limiter</code></em>
    <span class="type"><a href="language.types.string.html" class="type string">string</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.cache_limiter</em>
     指定会话页面所使用的缓冲控制方法（none/nocache/private/private_no_expire/public）。默认为
     <em>nocache</em>。参见
     <span class="function"><a href="function.session-cache-limiter.html" class="function">session_cache_limiter()</a></span>。
    </span>
   </dd>

  


  
   <dt id="ini.session.cache-expire">
    <em><code class="parameter">session.cache_expire</code></em>
    <span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.cache_expire</em> 以分钟数指定缓冲的会话页面的存活期，此设定对
     nocache 缓冲控制方法无效。默认为 <em>180</em>。参见
     <span class="function"><a href="function.session-cache-expire.html" class="function">session_cache_expire()</a></span>。
    </span>
   </dd>

  

  
   <dt id="ini.session.use-trans-sid">
    <em><code class="parameter">session.use_trans_sid</code></em>
    <span class="type"><a href="language.types.boolean.html" class="type boolean">boolean</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.use_trans_sid</em> 指定是否启用透明 SID
     支持。默认为 <em>0</em>（禁用）。
    </span>
    <blockquote class="note"><p><strong class="note">Note</strong>: 
     <span class="simpara">
      对于 PHP 4.1.2 或以下版本，可以通过加入
      <a href="configure.about.html#configure.enable-trans-sid" class="link"><em>--enable-trans-sid</em></a>
      配置选项去编译来启用，从 PHP 4.2.0 起，trans-sid 特性总是被编译。
     </span>
     <span class="simpara">
      基于 URL 的会话管理比基于 cookie 的会话管理有更多安全风险。例如用户有可能通过
      email 将一个包含有效的会话 ID 的 URL 发给他的朋友，或者用户总是有可能在收藏夹中存有一个包含会话
      ID 的 URL 来以同样的会话 ID 去访问站点。
     </span>
    </p></blockquote>
   </dd>

  
  
  
   <dt id="ini.session.bug-compat-42">
    <em><code class="parameter">session.bug_compat_42</code></em>
    <span class="type"><a href="language.types.boolean.html" class="type boolean">boolean</a></span>
   </dt>

   <dd>

    <span class="simpara">
     PHP 4.2.3 以及更低版本有一个未公开的特性／错误，它允许用户在
     <a href="ini.core.html#ini.register-globals" class="link">register_globals</a>
     被禁用的情况下在全局范围内初始化一个会话变量。PHP 4.3.0
     及更高版本会在使用此特性时并且启用了
     <a href="session.configuration.html#ini.session.bug-compat-warn" class="link">session.bug_compat_warn</a>
     时发出警告。此特性／错误可以通过关闭此选项而禁用。
    </span>
   </dd>

  
  
  
   <dt id="ini.session.bug-compat-warn">
    <em><code class="parameter">session.bug_compat_warn</code></em>
    <span class="type"><a href="language.types.boolean.html" class="type boolean">boolean</a></span>
   </dt>

   <dd>

    <span class="simpara">
     PHP 4.2.3 以及更低版本有一个未公开的特性／错误，它允许用户在
     <a href="ini.core.html#ini.register-globals" class="link">register_globals</a>
     被禁用的情况下在全局范围内初始化一个会话变量。PHP 4.3.0
     及更高版本会在使用此特性时并且同时启用了
     <a href="session.configuration.html#ini.session.bug-compat-42" class="link">session.bug_compat_42</a> 和
     <a href="session.configuration.html#ini.session.bug-compat-warn" class="link">session.bug_compat_warn</a>
     时发出警告。
    </span>
   </dd>

  

  
   <dt id="ini.session.hash-function">
    <em><code class="parameter">session.hash_function</code></em>
    <span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.hash_function</em> 允许用户指定生成会话
     ID 的散列算法。&#039;0&#039; 表示 MD5（128 位），&#039;1&#039; 表示 SHA-1（160 位）。
    </span>
    <blockquote class="note"><p><strong class="note">Note</strong>: 
     <p class="para">
      这是 PHP 5 引进的。
     </p>
    </p></blockquote>
   </dd>

  

  
   <dt id="ini.session.hash-bits-per-character">
    <em><code class="parameter">session.hash_bits_per_character</code></em>
    <span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>session.hash_bits_per_character</em>
     允许用户定义将二进制散列数据转换为可读的格式时每个字符存放多少个比特。可能值为
     &#039;4&#039;（0-9，a-f），&#039;5&#039;（0-9，a-v），以及 &#039;6&#039;（0-9，a-z，A-Z，&quot;-&quot;，&quot;,&quot;）。
    </span>
    <blockquote class="note"><p><strong class="note">Note</strong>: 
     <p class="para">
      这是 PHP 5 引进的。
     </p>
    </p></blockquote>
   </dd>

  

  
   <dt id="ini.url-rewriter.tags">
    <em><code class="parameter">url_rewriter.tags</code></em>
    <span class="type"><a href="language.types.string.html" class="type string">string</a></span>
   </dt>

   <dd>

    <span class="simpara">
     <em>url_rewriter.tags</em> 指定在使用透明 SID 支持时哪些 HTML
     标记会被修改以加入会话 ID。默认为
     <em>a=href,area=href,frame=src,input=src,form=fakeentry,fieldset=</em>。
    </span>
    <blockquote class="note"><p><strong class="note">Note</strong>: 
     <span class="simpara">
      如果要符合 XHTML，去掉 <em>form</em> 项并在表单字段前后加上
      &lt;fieldset&gt; 标记。
     </span>
    </p></blockquote>
   </dd>

  

  
   <dt id="ini.session.upload-progress.enabled">
    <em><code class="parameter">session.upload_progress.enabled</code></em>
    <span class="type"><a href="language.types.boolean.html" class="type boolean">boolean</a></span>
   </dt>

   <dd>

    <span class="simpara">
     Enables upload progress tracking, populating the <var class="varname"><var class="varname"><a href="reserved.variables.session.html" class="classname">$_SESSION</a></var></var> variable.
     Defaults to 1, enabled.
    </span>
   </dd>

  

  
   <dt id="ini.session.upload-progress.cleanup">
    <em><code class="parameter">session.upload_progress.cleanup</code></em>
    <span class="type"><a href="language.types.boolean.html" class="type boolean">boolean</a></span>
   </dt>

   <dd>

    <span class="simpara">
     Cleanup the progress information as soon as all POST data has been read
     (i.e. upload completed). Defaults to 1, enabled.
    </span>
    <blockquote class="note"><p><strong class="note">Note</strong>: 
     <span class="simpara">
      It is highly recommended to keep this feature enabled.
     </span>
    </p></blockquote>
   </dd>

  

  
   <dt id="ini.session.upload-progress.prefix">
    <em><code class="parameter">session.upload_progress.prefix</code></em>
    <span class="type"><a href="language.types.string.html" class="type string">string</a></span>
   </dt>

   <dd>

    <span class="simpara">
     A prefix used for the upload progress key in the <var class="varname"><var class="varname"><a href="reserved.variables.session.html" class="classname">$_SESSION</a></var></var>.
     This key will be concatenated with the value of
     <em>$_POST[ini_get(&quot;session.upload_progress.name&quot;)]</em> to
     provide a unique index.
    </span>
    <span class="simpara">
     Defaults to &quot;upload_progress_&quot;.
    </span>
   </dd>

  

  
   <dt id="ini.session.upload-progress.name">
    <em><code class="parameter">session.upload_progress.name</code></em>
    <span class="type"><a href="language.types.string.html" class="type string">string</a></span>
   </dt>

   <dd>

    <span class="simpara">
     The name of the key to be used in <var class="varname"><var class="varname"><a href="reserved.variables.session.html" class="classname">$_SESSION</a></var></var> storing
     the progress information. See also
     <a href="session.configuration.html#ini.session.upload-progress.prefix" class="link">session.upload_progress.prefix</a>.
    </span>
    <span class="simpara">
     If <em>$_POST[ini_get(&quot;session.upload_progress.name&quot;)]</em>
     is not passed or available, upload progressing will not be recorded.
    </span>
    <span class="simpara">
     Defaults to &quot;PHP_SESSION_UPLOAD_PROGRESS&quot;.
    </span>
   </dd>

  

  
   <dt id="ini.session.upload-progress.freq">
    <em><code class="parameter">session.upload_progress.freq</code></em>
    <span class="type"><a href="language.pseudo-types.html#language.types.mixed" class="type mixed">mixed</a></span>
   </dt>

   <dd>

    <span class="simpara">
     Defines how often the upload progress information should be updated.
     This can be defined in bytes (i.e. &quot;update progress information after every 100 bytes&quot;), or in percentages (i.e. &quot;update progress information after receiving every 1% of the whole filesize).
    </span>
    <span class="simpara">
     Defaults to &quot;1%&quot;.
    </span>
   </dd>

  

  
   <dt id="ini.session.upload-progress.min-freq">
    <em><code class="parameter">session.upload_progress.min-freq</code></em>
    <span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
   </dt>

   <dd>

    <span class="simpara">
     The minimum delay between updates, in seconds.
     Defaults to &quot;1&quot; (one second).
    </span>
   </dd>

  
 </dl>

 </p>

 <p class="para">
  The <a href="ini.core.html#ini.track-vars" class="link"><em>track_vars</em></a> and
  <a href="ini.core.html#ini.register-globals" class="link"><em>register_globals</em></a>
  configuration settings influence how the session variables get
  stored and restored.
 </p>

 <p class="para">
  Upload progress will not be registered unless
  session.upload_progress.enabled is enabled, and the
  $_POST[ini_get(&quot;session.upload_progress.name&quot;)] variable is set.
  See <a href="session.upload-progress.html" class="link">Session Upload Progress</a> for mor details on this functionality.
 </p>

 <p class="para">
  <a href="ini.core.html#ini.track-vars" class="link"><em>track_vars</em></a> 和
  <a href="ini.core.html#ini.register-globals" class="link"><em>register_globals</em></a>
  配置选项影响到会话变量是怎样存储和恢复的。
 </p>

 <blockquote class="note"><p><strong class="note">Note</strong>: 
  <p class="para">
   自 PHP 4.0.3 起，<a href="ini.core.html#ini.track-vars" class="link"><em>track_vars</em></a> 总是打开的。
  </p>
 </p></blockquote>

</div><hr /><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="session.installation.html">安装</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="session.resources.html">资源类型</a></div>
 <div class="up"><a href="session.setup.html">安装／配置</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
